home *** CD-ROM | disk | FTP | other *** search
/ NeXT Education Software Sampler 1992 Fall / NeXT Education Software Sampler 1992 Fall.iso / Programming / Source / WAIS / doc / waisserver.txt < prev    next >
Encoding:
Text File  |  1992-02-03  |  2.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. WAISSERVER(1)       UNIX Programmer's Manual        WAISSERVER(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      waisserver - serves WAIS requests
  10.  
  11.  
  12. SYNOPSIS
  13.      waisserver [ -p [ port_number ] ] [ -s ] [ -d directory ]
  14.      [ -e [ pathname ] ] [-u user ] [ -v ]
  15.  
  16.      waisserver.d
  17.           [ same arguments ]
  18.  
  19.  
  20. DESCRIPTION
  21.      Part of the Wide Area Information Server system.
  22.  
  23.      waisserver will take WAIS requests from a TCP port or
  24.      standard-io and return the appropriate response.  If the
  25.      name of the command is waisserver.d, then it is assumed it
  26.      is running from inetd, and it uses stdio for it's I/O sock-
  27.      ets.  See the examples below for inetd.conf.
  28.  
  29.  
  30. OPTIONS
  31.       -p [ port ]
  32.                Listen to the port.  If the port is supplied, then
  33.                that port number is used.  If it is not supplied
  34.                then the Z39.50 port (210) is used.
  35.  
  36.       -s       listen to standard I/O for queries.
  37.  
  38.       -d directory
  39.                Use this directory as the default location of the
  40.                indexes.  Therefore if the directory were
  41.                /usr/local, then the database foo would be found
  42.                in /usr/local/foo (see waisindex for how to create
  43.                an index)
  44.  
  45.        -e [ filename ]
  46.                Redirect error output to pathname, if supplied, or
  47.                to /dev/null.  Error output defaults to stderr,
  48.                unless -s is selected, in which case it defaults
  49.                to /dev/null.
  50.  
  51.        -u user Set the server's user id to the user specified
  52.                after attaching the tcp-port. This is only used if
  53.                the server is started as root.
  54.  
  55.        -v      Print the current version and date of the server.
  56.  
  57. EXAMPLES
  58.      The following are examples of waisserver usage:
  59.  
  60.      waisserver -p 8000 -d wais-sources -e server.log
  61.           Runs waisserver as a standalone server, using tcp port
  62.           8000 on directory wais-sources writing messages to
  63.           server.log
  64.  
  65.      Some example inetd.conf entries (note, these must be on one
  66.      line in inted.conf):
  67.  
  68.      hpux 7.0/800, Interactive/386 2.2.1:
  69.  
  70.      z3950 stream tcp nowait root /etc/waisserver waisserver.d
  71.       -d /wais-sources -e /server.log
  72.  
  73.      Ultrix 4.1:
  74.  
  75.      z3950 stream tcp nowait /etc/waisserver waisserver.d
  76.       -d /wais-sources -e /server.log
  77.  
  78.      Also, add the next line to /etc/services, and tickle your YP
  79.      server:
  80.  
  81.      z3950 210/tcp # wide area information server (wais)
  82.  
  83. SEE ALSO
  84.      waissearch(1), waisindex(1), waissearch-gmacs(1), xwais(1),
  85.      xwaisq(1), inetd(8C), inetd.conf(5)
  86.  
  87.      Wide Area Information Servers Concepts by Brewster Kahle.
  88.      Brewster@think.com
  89.  
  90. DIAGNOSTICS
  91.      The diagnostics produced by the waisserver is meant to be
  92.      self-explanatory.
  93.  
  94. BUGS
  95.      Under BSD logging information is sent to standard output,
  96.      instead of standard error.  This means the -e and -s options
  97.      won't work as expected.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.